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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill VirtueMart module. It assumes that you have 
an existing VirtueMart installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 

















Convention Description 

Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 

Glossary Glossary term 

Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the VirtueMart module? 
VirtueMart is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


VirtueMart has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via VirtueMart. 


Skrill customers using VirtueMart have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your VirtueMart backend and start taking payments. 
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3. Installing and configuring VirtueMart 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill VirtueMart module. The secret word is used to authenticate the data sent back 
to your VirtueMart server after payment. You must obtain the IP address of your VirtueMart server to 
configure the API/MQI password. You can find this IP address by executing the following command 
from a command prompt: 

ping <server domain name> 

For example: 


ping example.virtuemartserver.com 
Pinging example.virtuemartserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account 


1 

2. Go to Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your VirtueMart server. 
This prevents payment or money transfer requests from other IP addresses if your secret 
word or API password is compromised. All requests from other IP addresses are denied. 
Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase letter, 
and 1 number. 
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Setting 














GY Hom Developer Settings 
Conf API and security settings for your wallet account 
Br Transi 
Bla Bla Wallet 

# Banking 1D: 116404455, 
@® Balances Developer Settings : Bla Bla Wallet Il mum SEs S = mm HI ba to] i mm 
& Mi transactions Wallet IP Whitelisting API / MQ! / GSR / CVT Management API Documentation 
B User 

C Automated Payment Interface (API) Disabled Ce 
© Settings 

Allow requests to the API only from the following IP addresses. 

& Account Settings Your API secure IP addresses: ( Edit + Add 








867.120.141.129 


L) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQ! only from the following IP addresses, 


Your MQI secure IP addresses: + Add 


No active secure IP address found 





[E Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses, 


Your GSR secure IP addresses: 


(©) SetAPI/MQIPassword Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


ae 


E SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


ae 


tings | PrivacyNotice | Regulatory Disclosures | Cookie Notice 





©2020 Paysafe Holdings UK Limited. All rights reserved. Skrill? is a registered trademark of Paysafe Holdings UK Limited, Skrill Limited is registered in England and Wales with company number 04260907 and its registered office at 25 Canada Square, London E14 SLO. Authorised and regulated by the Financial Conduct 


Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your VirtueMart backend 
The next stage of the VirtueMart integration is to configure the VirtueMart module to connect to your 
Skrill account. The steps are as follows: 


1. Login to your VirtueMart admin account 


2. Click on VirtueMart from the top menu 
3. Select Payment methods 
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4. Click on Skrill Payment Solution 
5. Click on Configuration from the top side 
6. Insert Skrill credentials set up in the previous section (Figure 3-2) 


Account Credentials 

Merchant ID * 41223344 

Merchant email * test@merchant.com 
APIPassword* = = | ewes eeceee 

Secret word * ececece 

Display IFrame ~ 


Figure 3-2: Skrill Settings with example values in VirtueMart backend 


Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 
2. Enter your Skrill Merchant account email address 


Enter the API password and Secret word that you set up in the previoussection 
4. Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 


for a detailed explanation of all Skrill settings 


vo) 
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Table 3-1: Skrill Settings 











Account (email) 


account (created by you when you first signed up 
for a Skrill merchant account). 


Field Name Description Format/ Example 
Merchant ID Your unique merchant identifier. This is the 58010731 

Customer ID of your merchant account. 
Merchant The email address linked to your Skrill merchant | techpubs@skrill.com 





API Password 


The API password. This field is mandatory. It 
allows the VirtueMart server to receive payment 
information. 


N/A 





Secret word 


Enter the secret word configured for your Skrill 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your VirtueMart servers. 


N/A 





Display 








This setting has two options: IFrame and Redirect 


e IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
website. See Figure 3-3: for anexample. 


e Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 





IFrame 
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@ English United Kingdom 
VirtueMart 3 
51.99evR © Sample store 


=p) Skrill 42/01 nur © 


Card number 

Expiry date Security code 
MM || YY CVV 

Cardholder name 


Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 
is subject to the Skrill Privacy Policy. 


PAY NOW 


Cancel 





g= Skrill 


Figure 3-3: Iframe (embedded) option 
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4. Displaying Payment Methods 


You can select the payment methods to display to your customer using the Payment Configuration tab. 
The module has a series of payment method sections for each of the payment methods supported by 
Skrill. An example is displayed in Figure 4-1: 


Credit Card / Visa, Mastercard 


Enabled Yes = 
All countries except: Afghanistan, Cuba, Eritrea, Iran, Iraq, Japan, Kyrgyzstan, Libya, 
North Korea, Sudan, South Sudan and Syria 


Show separately Yes - 


S 


Sort Order 1 


Figure 4-1: Example Payment method section 


For each payment method, specify whether it should be displayed or not (enabled or not Table 4-1) in the 
list of Payment methods displayed in the VirtueMart Checkout. Hover over the “?” symbol to the right 
of each payment method to see the countries where it is available. See the Skrill Quick Checkout 
Integration Guide for a full list of countries and an up-to-date list of the countries where each payment 
method is supported. The payment methods are displayed in order of popularity in the customer’s 
country. 


Table 4-1: Payment Method Settings 


Field Name Description 





Enabled Determines whether this Payment method is displayed - Yes = display, No = 
Do not display. 

Under the Enabled setting is a list of the countries that support this payment 
method. If a Payment method is enabled but the customer’s country is not 
supported (determined by the country set in the billing address the customer 
chose in the VirtueMart Checkout) then it will not be shown. 





Show Always set this setting to Yes where available. 
Separately 














Please note that if the payment option is not enabled for your Skrill merchant account, enabling in 
from the backend would not make the payment option visible. You will need to contact 
merchantsupport@paysafe.com in order to discuss activating the specific payment option. 
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All Cards and Alternative Payment Methods 


This special payment option launches the Skrill Payment Form with multiple tabs showing all the 
supported Payment methods available in the customer’s country . The logo for this Payment option in the 
VirtueMart Checkout payment information section is as seen in Figure 4-2 below: 


All Cards and Alternative Payment 


Methods 

Enabled Yes = 
All countries except: Afghanistan, Cuba, Eritrea, Iran, Iraq, Japan, Kyrgyzstan, Libya, 
North Korea, Sudan, South Sudan and Syria 

Sort Order 0 


Figure 4-2: Setting up combined Skrill logo 


® English United Kingdom 
P VirtueMart 3 
51.99EurR Sample store 


=Æ] Skrill 42/9) meur © 


Card number 


Expiry date Security code 
MM YY CVV 


Cardholder name 
Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 
is subject to the Skrill Privacy Policy. 


PAY NOW 


Cancel 


v Skcill 


Figure 4-3: Multiple log 
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5. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill VirtueMart module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 
steps are unchanged. 


The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill VirtueMart Module 








Tax 20% Discount 
Safety Helmet XSF 40,83 € 4 2 3 8,17€ 49,00€ 
String, attribute Color: yellow, Logo: monochrome 
String, is input Retail 
Product prices result 8,17€ 49,00 € 
Save 
Selected shipment 50€ 2,99€ 
Self pick-up 2,49€ 


Selected payment 
Skrill Payment Solution 


or choose another payment 


Skrill 
VISAS Be cre 
Mama e 


o Skrill 


Paysafe:cash 
VISA © 

> 

o AAD; 


Figure 5-1: VirtueMart Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form 


® English United Kingdom 
VirtueMart 3 
51.99evR © Sample store 


Œ>) Skeill PAD) meur © 


Card number 

Expiry date Security code 
MM || YY CVV 

Cardholder name 


Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 
is subject to the Skrill Privacy Policy. 


PAY NOW 


Cancel 





g= Skrill 


Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


@® English United Kingdom 


51.99EuR Di | fea 


VS 





Successful payment 


itn Powered by 
g Skrill 
Figure 5-3: Successful Payment 


4. Click Continue to return to the VirtueMart Order Confirmation screen. This screen contains 
the unique order number for this payment 


Thank you for your Order! 


Payment Name Skrill Payment Solution 


Order No 89EJ017 


View your order 


Figure 5-4: Order Confirmation in VirtueMart Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© Engish France 
10.00«vr 
o 5 
@ Engitsh France © English France 
o mee 
=| © =| © = @ 
=p © 
visa SD 
visa SD vss €o 

Expiry date Security code Expiry date Security code 

MM YY cw | | aa Il ae EPR — Expiry date Security code 

MM | YY o EE 

Gardhħokler name Cardholder name 

First Last First Last Cardholder name 

First Last 
Email address Why? Email address Why? 
Email address Why? 
PAY NOW 
Poanes ty Powerd ty 
v Skrill Y=- Skrill Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 


16 


Skrill VirtueMart Module Configuration Guide 1.0 


6. Payment Information 


The VirtueMart module provides payment information in the Order screen with information about the 


payment method used for an order. 


Order Information - 


Order Number 89EJ017 
Order Date 08-26-2020 
Order Status Confirmed 
Last Updated 08-26-2020 
Shipment Self pick-up 
Payment Method Visa 
Shopper's note 

Total 51,99 € 


Figure 6-1: Payment Information Example 


Refunding Payments 

The process for Refunding customer payments is as follows: 
1. Go to VirtueMart from the top menu 
2. Select Orders 


3. Search for the customer’s invoice 





Order number / 
m Invoice Name / Email Payment Method Shipment Print View Order Date + Last Modified 


O 89EJ017 Customer Last Name Skrill Payment Solution Self pick-up = a Wednesday, Wednesday 
200826K3P4012 customer451@gmail.com = mm August 26 2020 August 26 2020 
09:47 10:02 


Figure 6-2: Search for Order 


4. Click the correct Order to view more information 
5. Check that the details are correct. 

6. Select Update Status 

7. Choose Refunded to update status 


Order 
Paid Status Notify Shopper? Total 1D 


¥  [confmea =| [Notify Shopper? 51,99€ 


(include Comment? 
Add Comment all lines? 
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Purchase Order 
Order Number 
Secret Key 
Order Date 
Order Status 
Name 

IP Address 


Invoice 


Payment & Shipment 
Payment Method 
Shipment 


Delivery Date 


Notes and special requests 


Terms of Service * 


E-Mail 


v 51,99€ 

893017 7 

P_2U4pKNXE 

Wednesday, August 26 2020 09:47 
Confirmed 

Customer Last Name 

157.167.59 xx 


200826K3P4012 


Skrill Payment Solution 
Self pick-up 


Same as invoice date 


Billing details 


customer451@gmail.com 
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Date Added Shopper Notified? Order Status Comment 

Wednesday, August 26 2020 09:47 No Pending 

Wednesday, August 26 2020 10:02 Yes Confirmed The payment through SKRILL for order 89EJ017 was successful. 
Update Status Q 


Update Status 


Order Status Confirmed z 
Comment 
Notify Shopper? a 


Include Comment? 
all lines? 


$ @ Save @ Cancel 
£ 


Company Name 


Figure 6-3: Refund Payment 


8. When status is updated a pop up will show confirming the successful refund 


Message 


1 order(s) have been updated 


Figure 6-4: Refunded Payment 
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7. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 7-1: Test Cards 











Brand Card Number 
MasterCard 5438311234567890 
Visa 4000001234567890 














Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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